home *** CD-ROM | disk | FTP | other *** search
/ Oh!X 2000 Spring / Oh!X 2000 Spring Special CD-ROM (Japan) (Part 2).7z / Oh!X 2000 Spring Special CD-ROM (Japan) (Part 2).bin / DXF / include / dsetup.h < prev    next >
C/C++ Source or Header  |  1999-09-08  |  10KB  |  314 lines
  1. /*==========================================================================
  2.  *
  3.  *  Copyright (C) 1995-1997 Microsoft Corporation.  All Rights Reserved.
  4.  *
  5.  *  File:       dsetup.h
  6.  *  Content:    DirectXSetup, error codes and flags
  7.  ***************************************************************************/
  8.  
  9. #ifndef __DSETUP_H__
  10. #define __DSETUP_H__
  11.  
  12. #include <windows.h>      // windows stuff
  13.  
  14. #ifdef _WIN32
  15. #define COM_NO_WINDOWS_H
  16. #include <objbase.h>
  17. #else
  18. #endif
  19.  
  20.  
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24.  
  25. typedef struct _DLSVERSION {
  26.  DWORD dwVersionMS;
  27.  DWORD dwVersionLS;
  28. } DLSVERSION, FAR * LPDLSVERSION;
  29.  
  30. #define FOURCC_VERS mmioFOURCC('v','e','r','s')
  31.  
  32. // DSETUP Error Codes, must remain compatible with previous setup.
  33. #define DSETUPERR_SUCCESS_RESTART        1
  34. #define DSETUPERR_SUCCESS                0
  35. #define DSETUPERR_BADWINDOWSVERSION     -1
  36. #define DSETUPERR_SOURCEFILENOTFOUND    -2
  37. #define DSETUPERR_BADSOURCESIZE         -3
  38. #define DSETUPERR_BADSOURCETIME         -4
  39. #define DSETUPERR_NOCOPY                -5
  40. #define DSETUPERR_OUTOFDISKSPACE        -6
  41. #define DSETUPERR_CANTFINDINF           -7
  42. #define DSETUPERR_CANTFINDDIR           -8
  43. #define DSETUPERR_INTERNAL              -9
  44. #define DSETUPERR_NTWITHNO3D            -10  /* REM: obsolete, you'll never see this */
  45. #define DSETUPERR_UNKNOWNOS             -11
  46. #define DSETUPERR_USERHITCANCEL         -12
  47. #define DSETUPERR_NOTPREINSTALLEDONNT   -13
  48. #define DSETUPERR_NEWERVERSION            -14
  49.  
  50. // DSETUP flags. DirectX 5.0 apps should use these flags only.
  51. #define DSETUP_DDRAWDRV         0x00000008      /* install DirectDraw Drivers           */
  52. #define DSETUP_DSOUNDDRV        0x00000010      /* install DirectSound Drivers          */
  53. #define DSETUP_DXCORE           0x00010000    /* install DirectX runtime              */
  54. #define DSETUP_DIRECTX  (DSETUP_DXCORE|DSETUP_DDRAWDRV|DSETUP_DSOUNDDRV)
  55. #define DSETUP_TESTINSTALL      0x00020000      /* just test install, don't do anything */
  56. #define DSETUP_USEROLDERFLAG    0x02000000        /* enable return DSETUPERR_NEWERVERSION */
  57. // Bug #22730 
  58.     // #define DSETUP_NTINSTALL        0x00080000        /* install on Win2K platform */
  59.  
  60. // These OBSOLETE flags are here for compatibility with pre-DX5 apps only.
  61. // They are present to allow DX3 apps to be recompiled with DX5 and still work.
  62. // DO NOT USE THEM for DX5. They will go away in future DX releases.
  63. #define DSETUP_DDRAW            0x00000001      /* OBSOLETE. install DirectDraw           */
  64. #define DSETUP_DSOUND           0x00000002      /* OBSOLETE. install DirectSound          */
  65. #define DSETUP_DPLAY            0x00000004      /* OBSOLETE. install DirectPlay           */
  66. #define DSETUP_DPLAYSP          0x00000020      /* OBSOLETE. install DirectPlay Providers */
  67. #define DSETUP_DVIDEO           0x00000040      /* OBSOLETE. install DirectVideo          */
  68. #define DSETUP_D3D              0x00000200      /* OBSOLETE. install Direct3D             */
  69. #define DSETUP_DINPUT           0x00000800      /* OBSOLETE. install DirectInput          */
  70. #define DSETUP_DIRECTXSETUP     0x00001000      /* OBSOLETE. install DirectXSetup DLL's   */
  71. #define DSETUP_NOUI             0x00002000      /* OBSOLETE. install DirectX with NO UI   */
  72. #define DSETUP_PROMPTFORDRIVERS 0x10000000      /* OBSOLETE. prompt when replacing display/audio drivers */
  73. #define DSETUP_RESTOREDRIVERS   0x20000000      /* OBSOLETE. restore display/audio drivers */
  74.  
  75.  
  76.  
  77. //******************************************************************
  78. // DirectX Setup Callback mechanism
  79. //******************************************************************
  80.  
  81. // DSETUP Message Info Codes, passed to callback as Reason parameter.
  82. #define DSETUP_CB_MSG_NOMESSAGE                     0
  83. #define DSETUP_CB_MSG_CANTINSTALL_UNKNOWNOS         1
  84. #define DSETUP_CB_MSG_CANTINSTALL_NT                2
  85. #define DSETUP_CB_MSG_CANTINSTALL_BETA              3
  86. #define DSETUP_CB_MSG_CANTINSTALL_NOTWIN32          4
  87. #define DSETUP_CB_MSG_CANTINSTALL_WRONGLANGUAGE     5
  88. #define DSETUP_CB_MSG_CANTINSTALL_WRONGPLATFORM     6
  89. #define DSETUP_CB_MSG_PREINSTALL_NT                 7
  90. #define DSETUP_CB_MSG_NOTPREINSTALLEDONNT           8
  91. #define DSETUP_CB_MSG_SETUP_INIT_FAILED             9
  92. #define DSETUP_CB_MSG_INTERNAL_ERROR                10
  93. #define DSETUP_CB_MSG_CHECK_DRIVER_UPGRADE          11
  94. #define DSETUP_CB_MSG_OUTOFDISKSPACE                12
  95. #define DSETUP_CB_MSG_BEGIN_INSTALL                 13
  96. #define DSETUP_CB_MSG_BEGIN_INSTALL_RUNTIME         14
  97. #define DSETUP_CB_MSG_BEGIN_INSTALL_DRIVERS         15
  98. #define DSETUP_CB_MSG_BEGIN_RESTORE_DRIVERS         16
  99. #define DSETUP_CB_MSG_FILECOPYERROR                 17
  100.  
  101.  
  102. #define DSETUP_CB_UPGRADE_TYPE_MASK             0x000F
  103. #define DSETUP_CB_UPGRADE_KEEP                  0x0001
  104. #define DSETUP_CB_UPGRADE_SAFE                  0x0002
  105. #define DSETUP_CB_UPGRADE_FORCE                 0x0004
  106. #define DSETUP_CB_UPGRADE_UNKNOWN               0x0008
  107.  
  108. #define DSETUP_CB_UPGRADE_HASWARNINGS           0x0100
  109. #define DSETUP_CB_UPGRADE_CANTBACKUP            0x0200
  110.  
  111. #define DSETUP_CB_UPGRADE_DEVICE_ACTIVE         0x0800
  112.  
  113. #define DSETUP_CB_UPGRADE_DEVICE_DISPLAY        0x1000
  114. #define DSETUP_CB_UPGRADE_DEVICE_MEDIA          0x2000
  115.  
  116.  
  117. typedef struct _DSETUP_CB_UPGRADEINFO
  118. {
  119.     DWORD UpgradeFlags;
  120. } DSETUP_CB_UPGRADEINFO;
  121.  
  122. typedef struct _DSETUP_CB_FILECOPYERROR
  123. {
  124.     DWORD dwError;
  125. } DSETUP_CB_FILECOPYERROR;
  126.  
  127.  
  128. #ifdef _WIN32
  129. //
  130. // Data Structures
  131. //
  132. #ifndef UNICODE_ONLY
  133.  
  134. typedef struct _DIRECTXREGISTERAPPA {
  135.     DWORD    dwSize;
  136.     DWORD    dwFlags;
  137.     LPSTR    lpszApplicationName;
  138.     LPGUID   lpGUID;
  139.     LPSTR    lpszFilename;
  140.     LPSTR    lpszCommandLine;
  141.     LPSTR    lpszPath;
  142.     LPSTR    lpszCurrentDirectory;
  143. } DIRECTXREGISTERAPPA, *PDIRECTXREGISTERAPPA, *LPDIRECTXREGISTERAPPA;
  144.  
  145. typedef struct _DIRECTXREGISTERAPP2A {
  146.     DWORD    dwSize;
  147.     DWORD    dwFlags;
  148.     LPSTR    lpszApplicationName;
  149.     LPGUID   lpGUID;
  150.     LPSTR    lpszFilename;
  151.     LPSTR    lpszCommandLine;
  152.     LPSTR    lpszPath;
  153.     LPSTR    lpszCurrentDirectory;
  154.     LPSTR    lpszLauncherName;
  155. } DIRECTXREGISTERAPP2A, *PDIRECTXREGISTERAPP2A, *LPDIRECTXREGISTERAPP2A;
  156.  
  157. #endif //!UNICODE_ONLY
  158. #ifndef ANSI_ONLY
  159.  
  160. typedef struct _DIRECTXREGISTERAPPW {
  161.     DWORD    dwSize;
  162.     DWORD    dwFlags;
  163.     LPWSTR   lpszApplicationName;
  164.     LPGUID   lpGUID;
  165.     LPWSTR   lpszFilename;
  166.     LPWSTR   lpszCommandLine;
  167.     LPWSTR   lpszPath;
  168.     LPWSTR   lpszCurrentDirectory;
  169. } DIRECTXREGISTERAPPW, *PDIRECTXREGISTERAPPW, *LPDIRECTXREGISTERAPPW;
  170.  
  171. typedef struct _DIRECTXREGISTERAPP2W {
  172.     DWORD    dwSize;
  173.     DWORD    dwFlags;
  174.     LPWSTR   lpszApplicationName;
  175.     LPGUID   lpGUID;
  176.     LPWSTR   lpszFilename;
  177.     LPWSTR   lpszCommandLine;
  178.     LPWSTR   lpszPath;
  179.     LPWSTR   lpszCurrentDirectory;
  180.     LPWSTR  lpszLauncherName;
  181. } DIRECTXREGISTERAPP2W, *PDIRECTXREGISTERAPP2W, *LPDIRECTXREGISTERAPP2W;
  182. #endif //!ANSI_ONLY
  183. #ifdef UNICODE
  184. typedef DIRECTXREGISTERAPPW DIRECTXREGISTERAPP;
  185. typedef PDIRECTXREGISTERAPPW PDIRECTXREGISTERAPP;
  186. typedef LPDIRECTXREGISTERAPPW LPDIRECTXREGISTERAPP;
  187. typedef DIRECTXREGISTERAPP2W DIRECTXREGISTERAPP2;
  188. typedef PDIRECTXREGISTERAPP2W PDIRECTXREGISTERAPP2;
  189. typedef LPDIRECTXREGISTERAPP2W LPDIRECTXREGISTERAPP2;
  190. #else
  191. typedef DIRECTXREGISTERAPPA DIRECTXREGISTERAPP;
  192. typedef PDIRECTXREGISTERAPPA PDIRECTXREGISTERAPP;
  193. typedef LPDIRECTXREGISTERAPPA LPDIRECTXREGISTERAPP;
  194. typedef DIRECTXREGISTERAPP2A DIRECTXREGISTERAPP2;
  195. typedef PDIRECTXREGISTERAPP2A PDIRECTXREGISTERAPP2;
  196. typedef LPDIRECTXREGISTERAPP2A LPDIRECTXREGISTERAPP2;
  197. #endif // UNICODE
  198.  
  199.  
  200. //
  201. // API
  202. //
  203.  
  204. #ifndef UNICODE_ONLY
  205. INT
  206. WINAPI
  207. DirectXSetupA(
  208.     HWND  hWnd,
  209.     LPSTR lpszRootPath,
  210.     DWORD dwFlags
  211.     );
  212. #endif //!UNICODE_ONLY
  213. #ifndef ANSI_ONLY
  214. INT
  215. WINAPI
  216. DirectXSetupW(
  217.     HWND   hWnd,
  218.     LPWSTR lpszRootPath,
  219.     DWORD  dwFlags
  220.     );
  221. #endif //!ANSI_ONLY
  222. #ifdef UNICODE
  223. #define DirectXSetup  DirectXSetupW
  224. #else
  225. #define DirectXSetup  DirectXSetupA
  226. #endif // !UNICODE
  227.  
  228.  
  229. #ifndef UNICODE_ONLY
  230. INT
  231. WINAPI
  232. DirectXDeviceDriverSetupA(
  233.     HWND  hWnd,
  234.     LPSTR lpszDriverClass,
  235.     LPSTR lpszDriverPath,
  236.     DWORD dwFlags
  237.     );
  238. #endif //!UNICODE_ONLY
  239. #ifndef ANSI_ONLY
  240. INT
  241. WINAPI
  242. DirectXDeviceDriverSetupW(
  243.     HWND   hWnd,
  244.     LPWSTR lpszDriverClass,
  245.     LPWSTR lpszDriverPath,
  246.     DWORD  dwFlags
  247.     );
  248. #endif //!ANSI_ONLY
  249. #ifdef UNICODE
  250. #define DirectXDeviceDriverSetup  DirectXDeviceDriverSetupW
  251. #else
  252. #define DirectXDeviceDriverSetup  DirectXDeviceDriverSetupA
  253. #endif // !UNICODE
  254.  
  255. #ifndef UNICODE_ONLY
  256. INT
  257. WINAPI
  258. DirectXRegisterApplicationA(
  259.     HWND                  hWnd,
  260.     LPVOID                  lpDXRegApp
  261.     );
  262. #endif //!UNICODE_ONLY
  263. #ifndef ANSI_ONLY
  264. INT
  265. WINAPI
  266. DirectXRegisterApplicationW(
  267.     HWND                  hWnd,
  268.     LPVOID                  lpDXRegApp
  269.     );
  270. #endif //!ANSI_ONLY
  271. #ifdef UNICODE
  272. #define DirectXRegisterApplication  DirectXRegisterApplicationW
  273. #else
  274. #define DirectXRegisterApplication  DirectXRegisterApplicationA
  275. #endif // !UNICODE
  276.  
  277. INT
  278. WINAPI
  279. DirectXUnRegisterApplication(
  280.     HWND     hWnd,
  281.     LPGUID   lpGUID
  282.     );
  283.  
  284. //
  285. // Function Pointers
  286. //
  287. #ifdef UNICODE
  288. typedef INT (WINAPI * LPDIRECTXSETUP)(HWND, LPWSTR, DWORD);
  289. typedef INT (WINAPI * LPDIRECTXDEVICEDRIVERSETUP)(HWND, LPWSTR, LPSTR, DWORD);
  290. typedef INT (WINAPI * LPDIRECTXREGISTERAPPLICATION)(HWND, LPVOID);
  291. #else
  292. typedef INT (WINAPI * LPDIRECTXSETUP)(HWND, LPSTR, DWORD);
  293. typedef INT (WINAPI * LPDIRECTXDEVICEDRIVERSETUP)(HWND, LPSTR, LPSTR, DWORD);
  294. typedef INT (WINAPI * LPDIRECTXREGISTERAPPLICATION)(HWND, LPVOID);
  295. #endif // UNICODE
  296.  
  297. typedef DWORD (FAR PASCAL * DSETUP_CALLBACK)(DWORD Reason,
  298.                                   DWORD MsgType,       /* Same as flags to MessageBox */
  299.                                   LPSTR szMessage,
  300.                                   LPSTR szName,
  301.                                   void *pInfo);
  302.  
  303. INT WINAPI DirectXSetupSetCallback(DSETUP_CALLBACK Callback);
  304. INT WINAPI DirectXSetupGetVersion(DWORD *lpdwVersion, DWORD *lpdwMinorVersion);
  305.  
  306. #endif // WIN32
  307.  
  308.  
  309. #ifdef __cplusplus
  310. };
  311. #endif
  312.  
  313. #endif
  314.